/*
 * Copyright (C) 2008 Alessandro Sivieri <alessandro.sivieri@chimera-bellerofonte.eu>.
 *
 *  This file is part of Daex.
 *
 *  Daex is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  Foobar is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
 */
package eu.chimera_bellerofonte.tesi.encoding;

import java.io.Serializable;


/**
 * Interfaccia di descrizione dei dettagli che un Encoder da utilizzare per il ripping deve contenere per poter essere impiegato; tipicamente viene implementato in coppia con la relativa sottoclasse Program.
 * @see eu.chimera_bellerofonte.tesi.encoding.Program
 * @author  Sivieri Alessandro
 * @author  Vitucci Nicola
 * @version  20/apr/07
 */
public interface Encoder extends Serializable
{
	static final long serialVersionUID = 1L;

	/**
	 * Metodo per ottenere il nome del programma da lanciare
	 * ed i suoi parametri.
	 * 
	 * @return un oggetto di descrizione del programma impiegato
	 */
	public Program getEncoderProgram();
	
	/**
	 * Metodo per ottenere il range di livelli di qualita'
	 * che l'encoder offre.
	 * 
	 * @return il range di qualita' dell'encoder
	 * @throws EncoderException per eventuali problemi di conding
	 */
	public int getQualityRange() throws EncoderException;
	
	/**
	 * Metodo per ottenere il valore di qualita' usato in quella istanza.
	 * @return  un valore valido per l'encoder prescelto
	 * @uml.property  name="quality"
	 */
	public int getQuality();
	
	/**
	 * Metodo per settare la qualita' dell'encoder.
	 * @param quality  il nuovo parametro di qualita' del ripping
	 * @throws EncoderException  eccezione lanciata se il valore non e' valido
	 * @uml.property  name="quality"
	 */
	public void setQuality(int quality) throws EncoderException;
	
	/**
	 * Metodo per ottenere il nome dell'encoder da titolare nella GUI.
	 * 
	 * @return una stringa che rappresenta il nome dell'encoder
	 */
	public String getEncoderTitle();
	
	/**
	 * Metodo per sapere se l'encoder programmato necessita di files wave
	 * itermedi o se lavora immediatamente dal dvd video.
	 * 
	 * @return true se necessita di files wave intermedi, false altrimenti
	 */
	public boolean needIntermediateWave();
}
